home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
FishMarket 1.0
/
FishMarket v1.0.iso
/
fishies
/
351-375
/
disk_353
/
aztecarp
/
arpreadme!
< prev
next >
Wrap
Text File
|
1992-05-06
|
5KB
|
109 lines
================== Arp 'wrapper' for Manx Aztec 'C' 5.0 ==================
==========================================================================
Arp is Copyright (c) 1987,88,89 by ARP Authors. All Rights Reserved.
Wrapper for Manx Aztec 'C' 5.0 updated by Olaf 'Olsen' Barthel of MXM.
================================ Purpose =================================
==========================================================================
The 5.0 update to the Aztec 'C' compiler comes with the new Arp
distribution files. That's fine, you may think, but: the linker
libraries do not work. Since Manx once more decided to change the format
of the object files all modules have to be recompiled. And there's the
second 'trap': you can't recompile the libraries using the supplied
files. Furthermore the original Arp distribution disk includes special
startup code which allows the creation of programs to be made resident
('pure'). Is this code included with the 5.0 release? I think you've
guessed it - it isn't. Some files wouldn't work properly (missing
INT32s), some wouldn't work at all (scdir.c).
These are the reasons why we at MXM have taken the opportunity to update
the original wrapper code as well as to add the missing files.
================================ Contents ================================
==========================================================================
This distribution includes 26 main files which are listed below. The
single library glue routines have been placed in the 'glue' subdirectory.
To recompile the package the contents of the 'glue' subdirectory have to
be moved to the main directory ('Move Glue /').
a.lib = Arp interface library (no startup code)
arp.lib = Arp interface library with startup code
arpdetach.o = Arp compatible detach.??? replacement
gads.o = Arp replacement for _cli_parse()
rstart.o = Resident module startup code
arpbase.h = Arp base main include file
arp.h = Arp function prototypes (Manx/Lattice)
clihelp.c = CLI Help string definition
cliparse.c = Standard CLI parsing module (with Arp flavour)
clitemp.c = CLI argument template
exit.c = Exit subroutine
fmalloc.c = Arp replacements for malloc, etc.
gads.c = Arp compatible replacement for cliparse.c
makefile = File needed to rebuild the libraries
pragma.c = File to be precompiled
scdir.c = Arp replacement for scdir()
vars.c = Arp global program variables
wbparse.c = Arp workbench parsing routine
_exit.c = Arp exit routine
_main.c = Arp main routine (calls your custom main())
aztecglue.asm = Arp library interface stubs (obsolete)
crt0.asm = Arp Aztec 'C' startup code
dospkt.asm = Arp replacement for dos_packet()
lvo.asm = Arp library vector offsets
rstart.asm = Source code for resident module startup code
tracker.asm = Arp item tracker source code
glue = Subdirectory containing 'C' glue code
================================= Usage ==================================
==========================================================================
The Arp libraries are linked just like the standard libraries. Note that
the default are 32 bit integers. If you want to build resident programs
all modules have to be compiled with the -m0b switch (to disable the
creation of the .begin statement).
Examples: CC -so Test.c
LN Test.o -Larp -Lc
CC -so -m0b Test.c
LN -o Test rstart.o Test.o -Larp -lc
Note that it is not recommended to use the arpdetach.o module together
with the rstart.o module unless you check the Arp resident list if you're
already on it (-> a resident program shouldn't do the segment split).
================================= Author =================================
==========================================================================
The files in this distribution were put together and updated by Olaf
'Olsen' Barthel of MXM. The author can be reached via standard mail at:
Olaf Barthel
Brabeckstrasse 35
3000 Hannover 71
Federal Republic of Germany
Or via electronic mail at:
Olaf Barthel@Fido 2:247/200
Digital Fantasy II (05 11 / 39 22 74)
============== Revision history (most recent change first) ===============
==========================================================================
V1.4 Fixed missing macros in scdir.c (ARRGH!).
V1.3 Split aztecglue.asm into single files (long file still included).
V1.2 Introduced new variable '__sloppy__' set TRUE if DOSBase was
initialized by startup code.
V1.1 Changes to vars.c, _main.c and rstart.asm to support resident
programs which don't use Arp.
V1.0 Initial update.